home *** CD-ROM | disk | FTP | other *** search
/ Internet Info 1994 March / Internet Info CD-ROM (Walnut Creek) (March 1994).iso / networking / osi / isode / osimis-2.0 / README < prev    next >
Encoding:
Text File  |  1990-06-18  |  7.2 KB  |  191 lines
  1. #######################################################################
  2. #                                      #
  3. # Copyright (c) 1988 University College London                  #  
  4. # All rights reserved.                              #
  5. #                                      #
  6. # Redistribution and use in source and binary forms are permitted     #
  7. # provided that the above copyright notice and this paragraph are     #
  8. # duplicated in all such forms and that any documentation,          #
  9. # advertising materials, and other materials related to such          #
  10. # distribution and use, acknowledge that the software was developed   #
  11. # by the Department of Computer Science, University College London.   #
  12. # The name of the University may not be used to                  #
  13. # endorse or promote products derived from this software without      #
  14. # specific prior written permission.                      #
  15. # THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR      #
  16. # IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED      #
  17. # WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR A PARTICULAR PURPOSE. #
  18. #                                      #
  19. #######################################################################
  20.  
  21.  
  22. THE UCL OSI MANAGEMENT SYSTEM
  23.  
  24. The contents of the `osimis' directory (stands for OSI Management Information 
  25. Service) implement the functionality of the UCL Management System.
  26. The system has been developed on top of the ISO Development Environment
  27. (ISODE) and at present it manages the ISODE transport layer. ISODE 
  28. availability is assumed for the system to be of any usefulness.
  29. The software was developed as part of UCL's work in the ESPRIT Project 395
  30. "INCA". For further information about project INCA contact either of the
  31. two addresses at the end of this text.
  32.  
  33. The system was initially developed on ISODE version 5.0 whose transport
  34. layer was modified to report the management information. The current version
  35. of the system (1.2) is based on ISODE version 6.0 which has officially
  36. incorporated the transport management hooks.
  37.  
  38.  
  39. The various subdirectories contain the following components of the system:
  40.  
  41. `msap' (stands for Management Service Access Point):
  42. it contains a library that implements the functionality of CMIS/CMIP 
  43. as in the documents:
  44.  
  45. Final ISO/DIS 9595 "Common Management Information Service Specification",
  46. January 1990.
  47.  
  48. Final ISO/DIS 9596 "Common Management Information Protocol Specification",
  49. January 1990.
  50.  
  51.  
  52. `sma' (stands for System Management Agent):
  53. it contains the System Management Agent (SMA) which is a management process 
  54. implementing the local Management Information Base (MIB) and enabling 
  55. access to it via CMIS. The management information concerns at present the
  56. ISODE transport layer and it is realised communicating with the active ISODE
  57. tranport entities (i.e. processes using ISODE transport services).
  58. The structure of the management information in the MIB conforms to the
  59. spirit of the document:
  60.  
  61. ISO TC97/SC21 WG4 N 2684 "OSI Management Information Services -
  62. Structure of Management Information", Washington Output, April 1988
  63.  
  64. The actual MIB supported is defined in INCA deliverable 2.2 Appendix B 
  65. and is reproduced in the file `docs/MIB'.
  66.  
  67.  
  68. `smap' (stands for System Management Application Process):
  69. it contains three different management processes that access and manipulate 
  70. the management information in the SMA.
  71.  
  72.  
  73. `misode' (stands for Managed ISODE):
  74. it contains a version of the ISODE library with the transport layer compiled
  75. with the management hooks in it to report management information to the SMA.
  76. It also contains a version of the ISODE imisc program linked with that
  77. library as an application to test the management system.
  78.  
  79.  
  80. The rest of the subdirectories are:
  81.  
  82. `h' (stands for Header files):
  83. contains the header files for the source code in `msap', `sma' and `smap.
  84.  
  85.  
  86. `docs' (stands for Documents):
  87. contains documents describing the management system.
  88.  
  89.  
  90. More information of what exactly each subdirectory contains
  91. may be found in README files in each.
  92.  
  93.  
  94. HOW TO INSTALL THE SYSTEM
  95.  
  96. The UCL Management System uses ISODE version 6.0 and has successfully run
  97. on Sun-3 workstations running SusOS 4.0 and on VAXstations running Ultrix. 
  98. We will describe below the necessary changes to enable the system to
  99. operate in a new environment.
  100.  
  101.  
  102. 1) The ISODE database should be updated first with entries for the
  103. SMA on the systems to provide and access the management service. Note
  104. that the SMA is a static server.  The application context and the
  105. provided service should be: 
  106.         context =    "management"
  107.         service    =    "SMA"
  108. The person who maintains ISODE at your site should be able to do that.
  109. If there is no such ISODE expert, an example with the UCL entries
  110. is given at the end of this file to help with this task.
  111.  
  112. 2) A UDP port for the service "manager" should be installed in /etc/services.
  113. This is needed for the local communication between the transport ISODE
  114. entities and the SMA (UDP server).
  115.  
  116. 3) On the systems that access the management service (usually a superset of 
  117. the systems that provide it), a configuration file with the names of the
  118. systems where SMAs run should be installed and the header file `h/config.h'
  119. should be edited - consult README file in `h'.
  120.  
  121. 4) Before you run make, the following paths in Config.mk should be edited
  122. to reflect the local configuration:
  123. ISODE    =    isode library directory
  124. INC    =    isode header file directory
  125. LIB    =    the directory to install the msap library
  126. DAEMON    =    the directory to install the sma program
  127. BIN    =    the directory to install the smap programs
  128.  
  129.  
  130. The Makefile in this directory makes and installs the `msap' library and
  131. the `sma' and `smap' management programs. In order to make and install
  132. the `misode', the Makefile in that directory should be used - see README file.
  133.  
  134. In order to make and install it, run "make; make install". 
  135. If you are interested in the msap library only (CMIS/P implementation), 
  136. you just need to run make in `msap'. 
  137.  
  138. In order to test the system, you can run a special version
  139. of the ISODE imisc program in `misode/imisc' linked with the isode library
  140. compiled with the transport management hooks. You will also need to modify
  141. the ISODE database - consult README file in `misode/imisc'.
  142.  
  143.  
  144.  
  145. HOW TO UPDATE THE ISODE DATABASE
  146.  
  147. The ISODE files `isobjects', `isoentities' and `isoservices' on the
  148. systems to provide and access the management service should be updated
  149. as follows:
  150.  
  151.  
  152. isobjects: you should register the application context associated with
  153.            an object identifier. In the UCL system the entry looks like:
  154.  
  155. "management"        1.17.5.5.0
  156.  
  157.  
  158. isoentities: you should register the presentation address of the service for
  159.              the hosts providing it. Two example entries for the UCL system:
  160.  
  161. ego    SMA        1.17.5.12.0 \
  162.             #603/Internet=ego.cs.ucl.ac.uk+11010
  163.  
  164. tiger    SMA        1.17.5.12.0 \
  165.             #603/Internet=tiger.cs.ucl.ac.uk+11010
  166.  
  167. The service object identifier is 1.17.5.12.0, the TCP port is 11010,
  168. the presentation and session selectors are NULL and the transport one is 603.
  169.  
  170.  
  171. isoservices: nothing, as the SMA is a static service.
  172.  
  173. The service and context object identifiers and the SMA TCP port number
  174. have been locally chosen.
  175.  
  176.  
  177. HOW TO UPDATE /ETC/SERVICES
  178.  
  179. The entry in the UCL /etc/services file for the SMA is:
  180.  
  181. manager        1099/udp        # SMA
  182.  
  183. The UDP port number for the SMA has been locally chosen.
  184.  
  185.  
  186.  
  187. Any problems in installing the system, comments and bugs should be reported to:
  188.  
  189.  - George Pavlou, gpavlou@uk.ac.ucl.cs
  190.  - Graham Knight, gknight@uk.ac.ucl.cs
  191.